home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / power201.zip / POWERQWK.DOC < prev    next >
Text File  |  1991-05-14  |  45KB  |  957 lines

  1.  
  2.          POWER-QWK v2.0  Shareware from POWERLINE SYSTEMS Ltd
  3.  
  4.            (C) Gale Green and PowerLine Systems Limited 1991
  5.  
  6.      POWER-QWK  is SHAREWARE. This means that you can try it  out 
  7.      to ensure that it suits your needs before you pay for it. It 
  8.      is  not free software and if you continue to use the program 
  9.      after a short period of testing you MUST register it. If you 
  10.      do  not wish to register you must cease using the  software. 
  11.      Info  on the very low registration cost is included  at  the 
  12.      end  of this DOC file. There is also a file  named  PRINT.ME 
  13.      included  with  Power-Qwk which you can print  and  post  to 
  14.      register the software, Upon registration you will be sent  a 
  15.      registration  number  which  will  not  only  allow  you  to 
  16.      register  this  version  of the  software  but  also  future 
  17.      versions. Register now and support the Shareware concept.
  18.      
  19.      This program may not be sold or included with any commercial 
  20.      product  without written permission from  Powerline  Systems 
  21.      Ltd.
  22.      
  23.      
  24.      Contents
  25.      ~~~~~~~~
  26.      
  27.           1. Background and Introduction to Power-QWK
  28.      
  29.           2. Installing Power-QWK
  30.      
  31.           3. Running Power-QWK
  32.      
  33.                3.1 Getting Started
  34.      
  35.                3.2 Configuration Manager
  36.      
  37.                3.3 The Message Base and Topics Menus
  38.      
  39.                3.4 The Bulletins Menu
  40.      
  41.                3.5 The Conference Menu
  42.      
  43.                3.6 Messages and Replies
  44.      
  45.                3.7 The History Menu
  46.      
  47.                3.8 Reading Files and Bulletins
  48.      
  49.                3.9 Automating Power-QWK
  50.      
  51.           4. Acknowledgments
  52.      
  53.           5. Disclaimer
  54.      
  55.           6. Registration and Support.
  56.      
  57.      1.   Background and Introduction to Power-QWK
  58.           
  59.           Power-QWK  was  born  of my  dissatisfaction  with  the 
  60.           offline  readers  available  for  bulletin  boards  and 
  61.           Online Services such as Direct-Line.
  62.           
  63.           None that I found offered any facilities for  retaining 
  64.           mail  or  bulletins in an orderly accessible  manner  - 
  65.           they  simply allowed the unpacking and reading of  mail 
  66.           packets which, once read, were of no further value.
  67.           
  68.           Power-QWK,  written for Direct-Line but usable  on  any 
  69.           Online  Service  which  has a Qmail  door,  is  a  full 
  70.           Message  Base Manager. The principal facilities are  as 
  71.           follows:
  72.           
  73.             -  permanent  storage  of  all  downloaded  messages, 
  74.                bulletins and standard files such as the  NEWFILES 
  75.                listing;
  76.           
  77.             -  full  ANSI  emulation for spectacular  viewing  of 
  78.                animated  messages  and  bulletins;  ANSI   format 
  79.                bulletins   are   recognised   automatically    by 
  80.                Power-QWK;
  81.  
  82.             -  friendly,  effective, access to your message  base 
  83.                with    one-key    commands    for     go-to-next, 
  84.                go-to-previous, find-next-in-thread, and so on;
  85.  
  86.             -  DOS  filing and printing of any message,  file  or 
  87.                bulletin, even printing ANSI bulletins as long  as 
  88.                they  don't contain upwards  cursor  repositioning 
  89.                sequences;
  90.  
  91.             -  reply  to a message received or 'say' an  original 
  92.                message, automatically including received messages 
  93.                in reply files to allow them to be quoted in  your 
  94.                replies,  optionally importing the contents  of  a 
  95.                DOS  file  into the message; several  methods  for 
  96.                'fancy' quoting;
  97.  
  98.             -  having  written a message, it can be  recalled  at 
  99.                any  time  prior  to  upload  (even  in  a   later 
  100.                Power-QWK session) to be edited or to have changed 
  101.                its Addressee, Destination Conference, Subject  or 
  102.                Public/Private Status;
  103.  
  104.             -  reply  deletion;  you can change your  mind  about 
  105.                sending  a  message  right up  to  the  moment  of 
  106.                upload;
  107.  
  108.             -  taglines:  witty one-liners added to the  ends  of 
  109.                your messages and replies; either selected by  you 
  110.                for  each message or added randomly  by  Power-QWK 
  111.                (or omitted if you don't like taglines);
  112.  
  113.             -  tagline  stealing:  you  can 'grab'  a  string  of 
  114.                characters for insertion in your tagline file from 
  115.                any  file,  bulletin  or message while  it  is  on 
  116.                display;
  117.  
  118.             -  almost  everything configurable, including  screen 
  119.                colours,  file  names, directory  names,  options, 
  120.                etc;
  121.  
  122.             -  multiple  message bases if you subscribe  to  more 
  123.                than one Online Service;
  124.  
  125.             -  automatic treatment of NEWFILES, appending to  the 
  126.                list   maintained  by  Power-QWK,   ignoring   the 
  127.                standard  files which appear as new every  day  on 
  128.                Wildcat!  services; a sort feature allows  you  to 
  129.                sort the NEWFILES list into alphanumeric sequence.
  130.  
  131.             -  automatic  memory  of which  files,  messages  and 
  132.                bulletins have been read plus the ability to  mark  
  133.                as read or unread or delete;
  134.  
  135.             -  message base prune facilities with the ability  to 
  136.                keep  as many day's messages as you wish  (may  be 
  137.                different  in  each conference) plus  the  ability 
  138.                either to discard pruned messages or save them  in 
  139.                a  Prune  Archive file (which looks  to  Power-QWK 
  140.                just  like  another  conference  so  even   pruned 
  141.                messages  may  be viewed and replied  to  just  as 
  142.                though   they   were  still  in   their   original 
  143.                conference);
  144.  
  145.             -  rebuild  and validation facilities to  ensure  the 
  146.                integrity  of  your message base  following  power 
  147.                failure  or  installation  of  a  new  version  of 
  148.                Power-QWK;
  149.  
  150.             -  automatic  installation procedure to  ensure  that 
  151.                Power-QWK  is installed properly with the  correct 
  152.                layout  and complement of help  and  configuration 
  153.                files. This procedure does not corrupt any  system 
  154.                files such as config.sys or autoexec.bat.
  155.  
  156. 2.   Installing Power-QWK
  157.      
  158.      Power-QWK Installation could not be simpler.
  159.      
  160.      Provided with Power-QWK is a file called INSTALL.EXE. If you 
  161.      execute  this  file  and  then  answer  the  straightforward 
  162.      questions  which  appear on the screen from  time  to  time, 
  163.      Power-QWK  installation should take no longer than a  couple 
  164.      of minutes.
  165.      
  166.      DO NOT ATTEMPT TO INSTALL POWERQWK OTHER THAN BY USING  THIS 
  167.      PROCEDURE. VITAL FILES WILL NOT BE CREATED, HELP FILES  WILL 
  168.      NOT  BE LOCATED CORRECTLY AND Power-QWK WILL NOT WORK AS  IT 
  169.      SHOULD.
  170.      
  171.      INSTALL.EXE CREATES FILES ONLY IN  THE  DIRECTORY  THAT  YOU 
  172.      TELL IT, PLUS IT CREATES ONE SUBDIRECTORY 'OWNED BY' THE TOP 
  173.      LEVEL Power-QWK DIRECTORY.
  174.  
  175.      SYSTEM FILES SUCH AS CONFIG.SYS  AND  AUTOEXEC.BAT  ARE  NOT 
  176.      WRITTEN TO OR TAMPERED WITH.
  177.  
  178.      ALSO, IF YOU LATER REGISTER YOUR COPY OF Power-QWK THEN  YOU 
  179.      WILL  NEED  TO  RUN  THE INSTALL  PROCEDURE  AGAIN  TO  TELL 
  180.      Power-QWK  YOUR REGISTRATION NUMBER - SO DO NOT  DELETE  THE 
  181.      FILE INSTALL.EXE EVEN WHEN INSTALLATION IS COMPLETE, YOU MAY 
  182.      NEED IT LATER!!
  183.      
  184.      e.g.,  if  you have downloaded Power-QWK  from  Direct-Line, 
  185.      then  you must have unzipped the file you received in  order 
  186.      to  read  this document. To install Power-QWK, use  the  DOS 
  187.      command  CD  to change to the directory containing  all  the 
  188.      downloaded  files and then type INSTALL and  press  Carriage 
  189.      Return.
  190.      
  191.      During the installation, the Power-QWK Configuration Manager 
  192.      will  be invoked. You will be asked a variety  of  questions 
  193.      related  to  the way in which Power-QWK is  to  handle  your 
  194.      mail, files, bulletins, archives, etc.
  195.      
  196.      If  you are unsure how to answer any question  simply  press 
  197.      Carriage  Return.  This causes Power-QWK to  use  a  default 
  198.      answer for the question. You can always change your mind  at 
  199.      a later date by running the Power-QWK Configuration  Manager 
  200.      again (see section 3.2).
  201.  
  202.  
  203. 3.   Running Power-QWK
  204.      
  205.      3.1  Getting Started
  206.           
  207.           To  run  Power-QWK, switch to the  directory  in  which 
  208.           Power-QWK  was installed, type POWERQWK and then  press 
  209.           the Enter key.
  210.           
  211.           e.g., if you installed Power-QWK in a directory  called 
  212.           C:\POWER then you should enter the following commands:
  213.           
  214.                       CD C:\POWER
  215.                       POWERQWK
  216.           
  217.           The  next  thing to appear will be the  Power-QWK  Main 
  218.           Menu.
  219.           
  220.           From  now on, you can press the F1 key at any  time  to 
  221.           obtain  full context-sensitive help for  ALL  Power-QWK 
  222.           functions.
  223.           
  224.           The  Help  files are the definitive  documentation  for 
  225.           Power-QWK.  If  you  would rather  have  this  text  in 
  226.           printed form then, at any time in Help, press P to send 
  227.           the currently active Help file to the printer.
  228.           
  229.           This   facility   is   intended   to   make   Power-QWK 
  230.           documentation  as  easy to use as possible -  you  only 
  231.           need to print out the bits that really interest you.
  232.           
  233.           Next,  select the item 'Process New Mail Packets'  from 
  234.           the menu and press Enter. If there are any mail packets 
  235.           (files  with  an  extension of .QWK)  in  the  Download 
  236.           Directory   you   specified   during   the    Power-QWK 
  237.           installation procedure then these will be unpacked.
  238.           
  239.           Power-QWK will automatically create a new message  base 
  240.           for  each  Online  Service for  which  there  are  mail 
  241.           packets. Each message base will be given the same  name 
  242.           as  the .QWK file name used by the online  service  so, 
  243.           for Direct-Line users, a message base named DLINE  will 
  244.           be created.
  245.           
  246.           This  name is obtained from INSIDE the .QWK file so  it 
  247.           does not matter if you have renamed your .QWK files for 
  248.           your  own convenience (as long as they still  have  the 
  249.           extension .QWK).
  250.           
  251.           If  Power-QWK finds more than one mail packet  then  it 
  252.           processes them in chronological order of file  creation 
  253.           time  within  date.  This is  not  strictly  necessary, 
  254.           Power-QWK can apply .QWK files to message bases in  any 
  255.           order,  but chronological order is fastest and  ensures 
  256.           that the proper bulletins are made current.
  257.           
  258.           Unless  you  have told it otherwise  in  Configuration, 
  259.           Power-QWK  will ask your permission before adding  each 
  260.           mail packet to the message base.
  261.           
  262.           You  will now see a sequence of messages,  telling  you 
  263.           that Power-QWK is creating your message base(s), adding 
  264.           new files, bulletins and messages and creating new Mail 
  265.           Conferences whenever required.
  266.           
  267.           Downloaded  NEWFILES  listings  are  appended  to   any 
  268.           already  existent  listing  within  the  message   base 
  269.           (remember  there  is a separate message base  for  each 
  270.           online  service to which you subscribe). The two  files 
  271.           which  appear  as  'new'  each  day  are  automatically 
  272.           ignored.
  273.           
  274.           Bulletins automatically overwrite any already  existent 
  275.           bulletins  with  the same number so your  message  base 
  276.           always  contains  the latest version of  each  bulletin 
  277.           maintained by your online service.
  278.           
  279.           Messages are stored in date/time order with a  separate 
  280.           file  and  index  being  created  for  each  conference 
  281.           (Wildcat Folder) supported by the online service.
  282.           
  283.           Whenever  Power-QWK detects the presence  of  messages, 
  284.           bulletins  or other files which are  time/date  stamped 
  285.           earlier than those already in the message base, it will 
  286.           ask you for confirmation before accepting them.
  287.           
  288.           When all .QWK files have been processed (if there  were 
  289.           any), Power-QWK displays its Main Menu.
  290.           
  291.           From  this menu, you can elect to enter  the  Power-QWK 
  292.           Offline   Reader  (if  any  message  bases  have   been 
  293.           created); call the Power-QWK Configuration Manager  (as 
  294.           you've already seen during Installation); or Quit.
  295.           
  296.           If you elect to Quit, Power-QWK closes down its  screen 
  297.           windows  plus  any open files and returns  to  the  DOS 
  298.           command line.
  299.           
  300.           If  you call the Configuration Manager or  the  Offline 
  301.           Reader (see below for details of what to do if you call 
  302.           one of these) then the appropriate part of Power-QWK is 
  303.           entered.  When  you quit the Configuration  Manager  or 
  304.           Offline Reader, you return to the Power-QWK Main Menu.
  305.  
  306.      3.2  Configuration Manager
  307.           
  308.           The  Power-QWK Configuration Manager is in  two  parts: 
  309.           General Configuration and Colour Customising.
  310.           
  311.           You can call the Power-QWK Configuration Manager either 
  312.           from  the Power-QWK Main Menu or by running one of  the 
  313.           programs  POWERCFG (General Configuration) or  POWERCOL 
  314.           (Colour Customising) in the Power-QWK main directory.
  315.           
  316.           Colour  Customising  shows you, on a full  screen,  the 
  317.           colours  that  are  used for  the  different  Power-QWK 
  318.           menus. You can change them by using single key strokes.
  319.           
  320.           If one menu is always seen 'on top  of' another  within 
  321.           Power-QWK  then it is shown in the same way  in  Colour 
  322.           Customising  so  that you can see how the  two  screens 
  323.           will look together.
  324.           
  325.           The  General  Configuration system is  menu-driven  and 
  326.           forms nothing more than a question-and-answer session.
  327.           
  328.           The  General Configuration Manager's main  menu  offers 
  329.           you  a selection of subject areas which you can  choose 
  330.           to  configure.  For instance, you may  choose  to  tell 
  331.           Power-QWK how you want your Personal mail to be handled 
  332.           or  you may wish to change the names of various  system 
  333.           files used by Power-QWK.
  334.           
  335.           You  can  press  F1 at any  time  within  Configuration 
  336.           Manager  to obtain full context-sensitive Help on  each 
  337.           item before committing yourself to a particular  course 
  338.           of action.
  339.           
  340.           Once you have installed Power-QWK and done the  initial 
  341.           configuration,   running  the   General   Configuration 
  342.           Manager  is  one  of the best ways  of  learning  about 
  343.           Power-QWK's facilities.
  344.           
  345.           Simply  press Enter to move from question  to  question 
  346.           without  changing any of your original  answers.  Every 
  347.           time you feel that you would like to know more about an 
  348.           item, press F1 to read the associated Help file.
  349.           
  350.           As  long  as  you keep  pressing  Enter,  Configuration 
  351.           Manager   will  continue  to  cycle  through  ALL   the 
  352.           Configuration questions.
  353.           
  354.           Press  Esc  when  reading  an item  to  return  to  the 
  355.           Manager's  Main  Menu;  press Esc  again  to  quit  the 
  356.           Manager.
  357.           
  358.           Information   supplied  by  you  in  response  to   the 
  359.           Configuration  Manager's questions is stored in a  file 
  360.           named POWERQWK.CFG.
  361.           
  362.           This file is accessed every time you call Power-QWK  so 
  363.           changes  you make have immediate effect, from the  next 
  364.           time you run Power-QWK.
  365.  
  366.      3.3  The Message Bases and Topics Menus
  367.           
  368.           When you first enter the Power-QWK Offline Reader  from 
  369.           the Main Menu, you will be offered one of two menus.
  370.           
  371.           If  you have more than one message base then  you  will 
  372.           first  be  asked to select one for  processing  at  the 
  373.           Message Bases Menu.
  374.           
  375.           You can have up to 30 message bases. Power-QWK sets one 
  376.           up  automatically whenever it processes a  .QWK  packet 
  377.           which  was downloaded from an online service  which  is 
  378.           new to Power-QWK.
  379.           
  380.           Once  you have selected a message base, you move on  to 
  381.           the  Power-QWk  Topics Menu. You will  have  come  here 
  382.           straight away if you have only one message base.
  383.           
  384.           The available Topics represent the constituent parts of 
  385.           .QWK  mail packets: Hello, News,  Bulletins,  NewFiles, 
  386.           Messages, User Info and Goodbye.
  387.           
  388.           Hello,  News  and  Goodbye are  files  of  information, 
  389.           supplied by the Sysop of the Online Service.
  390.           
  391.           User  Info is a screen of information relating to  your 
  392.           use  of  the  online service - how  many  times  you've 
  393.           logged  on to date, how many files you've uploaded  and 
  394.           downloaded, etc.
  395.           
  396.           Bulletins   are   files  of  information   related   to 
  397.           particular topics of interest. On Direct-Line, any  one 
  398.           Bulletin  Number will nearly always relate to the  same 
  399.           topic. For instance, Bulletin 14 is always the  current 
  400.           list of the top twenty most active Direct-Line users.
  401.           
  402.           NewFiles  is  a  listing of all new  files  which  have 
  403.           become  available for download from the online  service 
  404.           since the last time you looked.
  405.           
  406.           'Messages' are the Personal and Public mail items which 
  407.           were available for you to read on the online service at 
  408.           the time you did your download.
  409.           
  410.           The  Topics  Menu, and all its  underlying  menus,  are 
  411.           designed  to  allow you to read  all  currently  unread 
  412.           files,  bulletins and messages by  repeatedly  pressing 
  413.           the Enter key.
  414.           
  415.           When you press Enter at the Topics Menu, for  instance, 
  416.           if  the  currently highlighted  Topic  contains  unread 
  417.           information   then   Power-QWK   will   present    that 
  418.           information for reading. Pressing Enter repeatedly will 
  419.           cause  Power-QWK  to present all unread  items  in  the 
  420.           Topic,  in sequence. When there are no  further  unread 
  421.           items, Power-QWK returns to the Topics Menu.
  422.           
  423.           If  the  current Topic contains no  unread  information 
  424.           then Power-QWK moves on to the next item automatically.
  425.           
  426.           Sometimes, you will want to read items or browse topics 
  427.           which  you have read already. If this is the case  then 
  428.           use  Tab instead of Enter. Tab forces entry to a  topic 
  429.           even if it contains no unread items.
  430.           
  431.           In the case of the NewFiles Topic, Enter allows you  to 
  432.           read "today's" NewFiles. Tab lets you see ALL  newfiles 
  433.           to date.
  434.           
  435.           Power-QWK also has a powerful multi-phase sort facility 
  436.           which  allows  you  to  sort  the  NewFiles  file  into 
  437.           alphanumeric  sequence, at the same time including  any 
  438.           old  NewFiles files which you may have  accumulated  in 
  439.           the  past, perhaps using some other less powerful  mail 
  440.           reader. Press F1 (Help) at the Topics Menu for details.
  441.           
  442.           Most Wildcat! Online services include two special files 
  443.           in the NewFiles listing every day. Power-QWK recognises 
  444.           these and ignores them automatically.
  445.           
  446.           If you ever subscribe to a Service which includes  only 
  447.           one,  or more than two, such files then you can  inform 
  448.           Power-QWK  of the correct number by pressing N  at  the 
  449.           Topics Menu.
  450.           
  451.           Having selected an item from the Topics Menu, you  will 
  452.           be shown single-file items like Hello and News straight 
  453.           away.  If,  however, you choose Bulletins  or  Messages 
  454.           then you will be presented with a further menu.
  455.  
  456.      3.4  The Bulletins Menu
  457.           
  458.           At the Bulletins menu, you can choose to read or delete 
  459.           any of up to 1000 bulletins, depending on how many  are 
  460.           supported by your online service. As with all Power-QWK 
  461.           menus, there is a 'Key Line' at the foot of the screen, 
  462.           to remind you of the one-or-two-key commands which  are 
  463.           available.  For more detailed information, press F1  to 
  464.           obtain context-sensitive Help.
  465.           
  466.           As  with  the Topics Menu, Tab rather than  Enter  will 
  467.           allow you to read Bulletins even if they have been read 
  468.           already.  Pressing  Enter skips  bulletins  which  have 
  469.           already been read.
  470.           
  471.           The Bulletin numbers are presented ten to a screen  and 
  472.           you  can  read  'all currently  unread'  by  repeatedly 
  473.           pressing Enter.
  474.           
  475.           You can select specific numbers by moving the  Bulletin 
  476.           highlight  bar with the cursor and/or paging  keys  and 
  477.           then pressing Enter or Tab.
  478.           
  479.           Press Del to delete the highlighted Bulletin (Power-QWK 
  480.           will   ask  for  confirmation  before  performing   the 
  481.           deletion).
  482.           
  483.           As with all Power-QWK information and message  screens, 
  484.           once you are actually reading a bulletin, you can press 
  485.           P to print it, F to file it (in a DOS file) and you can 
  486.           press  L  or  N if you  require  Linefeeds  or  Newpage 
  487.           characters  sending  to  the  printer  to  format  your 
  488.           output.
  489.  
  490.      3.5  The Conference Menu
  491.           
  492.           If  you select Messages at the Topics  Menu,  Power-QWK 
  493.           moves on to the Conference Menu. With current  releases 
  494.           of  Wildcat!, a Power-QWK Conference corresponds  to  a 
  495.           Wildcat! Message Folder.
  496.           
  497.           Conferences are presented for selection in alphabetical 
  498.           sequence, ten to a screen. Two exceptions to this  rule 
  499.           are   Personal  Mail  Conference  and   Prune   Archive 
  500.           Conference,  described  later. If you have  a  Personal 
  501.           Mail  Conference  then it always appears first  in  the 
  502.           list  of  conferences;  if you  have  a  Prune  Archive 
  503.           Conference  then  it  always appears  last.  The  Prune 
  504.           Archive  conference also has the distinction of  always 
  505.           being skipped by pressing Enter - you must press Tab to 
  506.           read the Prune Archive Conference.
  507.           
  508.           Similar in action to the Bulletins Menu, you can  enter 
  509.           in  turn each conference which contains unread mail  by 
  510.           repeatedly pressing the Enter key. Continuing to  press 
  511.           Enter  will automatically page you through  all  unread 
  512.           messages in each such conference, finally returning  to 
  513.           the  Conference  Menu  whenever there  are  no  further 
  514.           unread messages in a conference.
  515.           
  516.           As  well as forming a gateway to the mail  conferences, 
  517.           the Conference Menu also offers some extra  facilities, 
  518.           each obtained by pressing a single key:
  519.           
  520.           P -  Prune current conference or all conferences;  this 
  521.                causes Power-QWK to discard out-of-date  messages, 
  522.                retaining  the number of days' worth  of  messages 
  523.                specified  either in Configuration Manager  or  by 
  524.                pressing D (see below).
  525.                
  526.                Old  messages will either be discarded or, if  you 
  527.                have  specified to the Configuration Manager  that 
  528.                you  wish  to  keep  a  Prune  Archive,  then  old 
  529.                messages will be added into the PRUNE Conference.
  530.                
  531.                Here, they can be viewed and responded to just  as 
  532.                though  they  were still in  their  conference  of 
  533.                origin.
  534.  
  535.           D -  set  prune Days. This allows you to  set  specific 
  536.                values for each conference, over-riding the global 
  537.                value   you   have   already   set   in    General 
  538.                Configuration Manager.
  539.                
  540.                You  might for instance want to keep the  contents 
  541.                of your Personal Mail conference (if you have one) 
  542.                forever.  Just  set  the number  of  days  on  the 
  543.                PERSONAL conference to 999.
  544.                
  545.                You  might  wish  to keep messages  in,  say,  the 
  546.                COMPUTER  conference for a fortnight but for  only 
  547.                five days in, say, the COMMS conference.
  548.  
  549.           R -  Rebuild; press R againfor full Rebuild or press  V 
  550.                just to Validate Counters;
  551.                
  552.                Rebuild  completely  reconstructs  all  Conference 
  553.                Message  Indexes, ensuring that they  truly  match 
  554.                the contents of the actual Message Files.
  555.                
  556.                Validate  Counters simply checks and  corrects  if 
  557.                necessary all of Power-QWKs Pointers and Counters, 
  558.                ensuring  that they reflect the true  contents  of 
  559.                the Message Indexes.
  560.                
  561.                If  you ever doubt the integrity of  your  message 
  562.                base,  run Validate Counters. If you are still  in 
  563.                doubt then run Rebuild.
  564.  
  565.           E -  Edit Taglines. If you like to use taglines,  witty 
  566.                one-liners  added to the bottom of your  messages, 
  567.                then  this  key allows you to edit  your  file  of 
  568.                taglines - POWERQWK.TAG.
  569.                
  570.                If you have set 'Select each time' in the Taglines 
  571.                section of General Configuration Manager then  you 
  572.                can  also edit POWERQWK.TAG by pressing E  at  the 
  573.                Taglines Selection screen.
  574.  
  575.           R -  mark  Read.  This  causes  all  messages  in   the 
  576.                highlighted  conference  to  be  marked  as  Read, 
  577.                whether you have actually read them or not.
  578.  
  579.           U -  mark  Unread.  This  causes all  messages  in  the 
  580.                highlighted  conference  to be marked  as  unread, 
  581.                even if they have actually been read.
  582.  
  583.           H -  History.  This  allows  you  to  edit,  or  change 
  584.                details  of,  all  messages  which  are  currently 
  585.                waiting  to  be packed for upload  to  the  online 
  586.                service. This includes all messages written during 
  587.                the  current Power-QWK session AND any written  in 
  588.                previous  sessions  which have not  been  uploaded 
  589.                yet.
  590.                
  591.                At the History Menu, you can change the  Addressee 
  592.                of  any message, the Subject (Title),  the  Status 
  593.                (Public  or Private), the  destination  Conference 
  594.                (Wildcat!  Message Folder) or the  actual  message 
  595.                contents.
  596.  
  597.           S -  Say.  This  allows you to 'say' a message  to  the 
  598.                highlighted conference. Say is distinct from Reply 
  599.                in that Say potentially initiates a conversational 
  600.                thread whereas Reply continues one.
  601.                
  602.                If  you  'Say'  to either the  PERSONAL  or  PRUNE 
  603.                conference  then,  after  entering  your  message, 
  604.                Power-QWK  will  offer  you a  list  of  available 
  605.                conferences   from  which  you  may   choose   the 
  606.                destination.
  607.                
  608.                As with all Power-QWK Menus and screens,  pressing 
  609.                G enters a Gateway to DOS, allowing you to 'shell' 
  610.                to the operating system, enter commands, and  then 
  611.                type EXIT to return to Power-QWK.
  612.  
  613.      3.6  Messages and Replies
  614.           
  615.           When  you are reading a conference, i.e., you  actually 
  616.           have a message on the screen, there are many facilities 
  617.           available at the press of a key or two.
  618.           
  619.           As usual, the best way to learn about them is to read a 
  620.           conference, get a message on the screen and then  press 
  621.           F1 for Help.
  622.           
  623.           You can practice as much as you like. Then, when you've 
  624.           finished,  return to the Conference Menu, press  H  for 
  625.           History and then delete any practice messages you  have 
  626.           created but don't want to send.
  627.           
  628.           As  with all Power-QWK screens, there is a Key Line  at 
  629.           the foot containing a list of all (or most) of the keys 
  630.           that  you can press to cause specific actions. Even  if 
  631.           there  is  no  room for all the available  keys  to  be 
  632.           mentioned  in the Key Line, they will all be  described 
  633.           in Help.
  634.           
  635.           When  reading a message, the Enter and Page  Down  keys 
  636.           have  the same effect: move on to the next page of  the 
  637.           current message or, if there are no more pages, move on 
  638.           to  the next unread message in the  current  conference 
  639.           or, if there are no more unread messages, return to the 
  640.           Conference Menu.
  641.           
  642.           The other available keys are as follows:
  643.           
  644.           
  645.           R -  Reply to the current message. Power-QWK constructs 
  646.                a  reply  file  containing  the  current  message, 
  647.                automatically incorporating the Quoting style  you 
  648.                have  requested in General Configuration  Manager, 
  649.                and then calls your Editor Program, also named  in 
  650.                Configuration Manager.
  651.                
  652.                When  you  exit  from your editor  and  return  to 
  653.                Power-QWK, a tagline will be appended if  required 
  654.                and the message will then be added to the file  of 
  655.                messages waiting for upload.
  656.                
  657.                Power-QWK will automatically direct the message to 
  658.                the  same  conference as that of  the  message  to 
  659.                which  you are replying. You will be prompted  for 
  660.                Subject, Addressee and Public/Private Status.
  661.                
  662.                You will be offered the name of the sender of  the 
  663.                original message as the default Addressee name but 
  664.                you  can  change this if you wish or press  F2  to 
  665.                bring  up a list of your top twenty most  recently 
  666.                used addressee names, from which you can select  a 
  667.                name to use without actually typing it.
  668.                
  669.                Then,  you will be asked if you wish to  send  any 
  670.                carbon  copies to any other addressees. These  may 
  671.                have  different Public/Private Status and  Subject 
  672.                fields to the original reply (these fields are all 
  673.                changeable later at the History Menu anyway).
  674.                
  675.                You  can  use F2 to obtain the names  of  all  the 
  676.                carbon copy recipients.
  677.  
  678.           I -  same  as  R  but, as  well  as  incorporating  the 
  679.                original message in the reply file, Power-QWK will 
  680.                also Include a file which you nominate.
  681.  
  682.           S -  'Say'  a  message to the current  conference.  You 
  683.                cannot  Say to PRUNE or PERSONAL in  this  manner. 
  684.                i.e., a 'proper' conference must be current.
  685.                
  686.                This  is similar in action to R for  Reply  except 
  687.                that Power-QWK will not be able to offer a default 
  688.                Addressee  name  and obviously there  will  be  no 
  689.                original message placed in the reply file.
  690.                
  691.                You  can  still use F2 to pick an  addressee  from 
  692.                your  top-twenty list and taglines are  added  (or 
  693.                not) as normal.
  694.  
  695.           X -  same  as  S but Power-QWK will  include  an  eXtra 
  696.                file, which you nominate, in the reply file.
  697.  
  698.           A -  Animate   the  current message. If you  receive  a 
  699.                message which contains Ansi sequences then press A 
  700.                to  see the file 'properly' including full  colour 
  701.                and animation capability.
  702.                
  703.                This  facility  has the bonus that  you  can  also 
  704.                decipher  messages which contain  cursor  movement 
  705.                sequences.  Sometimes, you will  receive  messages 
  706.                which contain sequences of [D [C or similar. These 
  707.                are  implanted  in  the file as a  result  of  the 
  708.                sender  using  the cursor keys to  'go  back'  and 
  709.                correct  errors.  Press A for  Animate  and  these 
  710.                sequences  will  be translated  into  the  correct 
  711.                on-screen  cursor  movements so that you  see  the 
  712.                message as the sender intended.
  713.  
  714.           T -  steal a Tagline from the current message.
  715.  
  716.           As   with all Power-QWK screens, you can use F to  File 
  717.           the  current  message, P to Print it plus N and  L  for 
  718.           Newpage and Linefeed respectively.
  719.           
  720.           You can also use the cursor keys to move to a different 
  721.           message in the conference, whether it has been read  or 
  722.           not.
  723.           
  724.           CursorUp/Down  moves  to the Previous/Next  message  in 
  725.           chronological sequence.
  726.           
  727.           Ctrl-CursorUp/Down  moves to the Previous/Next  message 
  728.           in  the current thread (Wildcat! defines a 'thread'  as 
  729.           any group of messages which have the same Subject).
  730.           
  731.           Home and End move to the chronologically first and last 
  732.           messages in the conference.
  733.           
  734.           Alt-CursorUp/Down  allows you set full Wildcard  search 
  735.           criteria  on  the To, From and Subject  fields,  for  a 
  736.           Backwards/Forwards  search  of the  current  conference 
  737.           from  the  current  position.  You  can  use  as   many 
  738.           wildcards  as  you  like in  search  criteria  so,  for 
  739.           instance, From=steve* plus Subject=*pc* will match  all 
  740.           messages from people whose names begin with the letters 
  741.           'steve'   which   have   the  letters   'p'   and   'c' 
  742.           consecutively   anywhere  in  their   titles.   Pattern 
  743.           matching is case insensitive.
  744.           
  745.           Having  set  the  criteria  for  a   Forwards/Backwards 
  746.           Search,  repeated  pressing  of the F2  key  finds  all 
  747.           matching  messages in the message base between  current 
  748.           position and End/Beginning of the conference.
  749.           
  750.           Once  search criteria have been set, they survive  even 
  751.           changes  of conference. So you can set up a search  and 
  752.           then perform it in as many conferences as you like.
  753.           
  754.           Note that Power-QWK allows the D and U keys to be  used 
  755.           instead  of CursorDown and CursorUp. This will help  if 
  756.           your  system  does not support, for instance,  the  key 
  757.           combinations  Ctrl-CursorDown or Alt-CursorDown  -  use 
  758.           Ctrl-D or Alt-D instead.
  759.           
  760.           As always, you can press G to pass through the  Gateway 
  761.           to DOS, enter commands and then type EXIT to return  to 
  762.           Power-QWK.
  763.           
  764.           Above all, don't forget F1 for Help.
  765.  
  766.      3.7  The History Menu
  767.           
  768.           This  menu shows all the prepared messages and  replies 
  769.           which  are waiting to be uploaded. They may  have  been 
  770.           prepared in the current Power-QWK session or in one  or 
  771.           more previous sessions.
  772.           
  773.           Messages  and  replies are placed by Power-QWK  into  a 
  774.           file  called *.MSG where * represents the  mail  packet 
  775.           name   used  by  the  online  service.   Messages   for 
  776.           Direct-Line go into a file named DLINE.MSG.
  777.           
  778.           Whenever you end a Power-QWK session, the file *.MSG is 
  779.           packed,  using the Packer Program supplied  to  General 
  780.           Configuration Manager, into a further file named *.REP.
  781.           
  782.           *.REP  is  the  file which you have to  upload  to  the 
  783.           Tomcat! door in the online service.
  784.           
  785.           Whenever you select 'Messages' at the Power-QWK  Topics 
  786.           Menu, Power-QWK automatically attaches to, and  unpacks 
  787.           into *.MSG, any already existent *.REP file. So you can 
  788.           append  to  this  file during  the  course  of  several 
  789.           Power-QWK sessions.
  790.           
  791.           The  History  Menu shows all the messages  and  replies 
  792.           which  currently  reside  in *.MSG. You  can  move  the 
  793.           highlight bar to point to a specific message using  the 
  794.           usual cursor and paging keys.
  795.           
  796.           The following commands are available at this menu:
  797.  
  798.           T -  change  the contents of the To field. You can  use 
  799.                F2 to call up your top-twenty Addressee Pick  List 
  800.                if you wish.
  801.  
  802.           S -  change the contents of the Subject field.
  803.  
  804.           C -  change  the  name of the  destination  Conference. 
  805.                Power-QWK will display a multi-page screen  called 
  806.                the   Conference  Pick  List,  showing   all   the 
  807.                available  conferences. Just highlight a name  and 
  808.                press Enter.
  809.  
  810.           P -  toggle the Private/Public Status field.
  811.  
  812.           A -  'Also  send'  the highlighted message  to  another 
  813.                Addressee.  Having pressed A, you can press F2  to 
  814.                access the Addressee Pick List.
  815.  
  816.           Enter -   edit the contents of the highlighted message.
  817.                     
  818.                     This  action has the side-effect  of  causing 
  819.                     the  highlighted message to be moved  to  the 
  820.                     end  of the *.MSG file (and therefore to  the 
  821.                     end of the History Menu)
  822.  
  823.           Del -     Delete  the  highlighted  message.  Power-QWK 
  824.                     will  ask for confirmation before  performing 
  825.                     the deletion.
  826.  
  827.           G   -     Gateway to DOS
  828.  
  829.  
  830.      3.8  Reading Files and Bulletins
  831.           
  832.           Having  selected a file or bulletin to read,  Power-QWK 
  833.           automatically analyses the contents of the file to  see 
  834.           how it is formatted.
  835.           
  836.           Power-QWK recognises fully formatted Ansi files,  which 
  837.           may have many screens delimited by Home/Clear sequences 
  838.           (Esc[2J).  Power-QWK  has full Ansi  animation  so  the 
  839.           files can be in colour and contain any amount of cursor 
  840.           movement.
  841.           
  842.           Non-Ansi  files must either be CR/LF delimited  or  not 
  843.           delimited at all. In the latter case, Power-QWK inserts 
  844.           a CR/LF pair every 80 bytes when displaying.
  845.           
  846.           Once the file or bulletin is on display, you can scroll 
  847.           up or down through the file using the PgUp, PgDn,  Home 
  848.           and End keys.
  849.           
  850.           You can also press any of the following characters:
  851.           
  852.           P -  Print the file or bulletin.
  853.  
  854.           F -  File (in a DOS file) the file or bulletin.
  855.  
  856.           N -  Send a NewPage (Formfeed) character to the printer 
  857.                device.
  858.  
  859.           L -  Send a LineFeed character to the printer device.
  860.  
  861.           T -  Steal a Tagline from the display.
  862.  
  863.           Enter - same as PgDn.
  864.           
  865.           Esc - Quit the current file or bulletin.
  866.  
  867.      3.9  Automating Power-QWK
  868.           
  869.           If you are an experienced online user then you may wish 
  870.           to  incorporate a call of Power-QWK into a script  file 
  871.           or   .BAT   file  so  that  downloaded   messages   are 
  872.           automatically  incorporated  in your  message  base  in 
  873.           'hands free' mode.
  874.           
  875.           To accomplish this, call General Configuration  Manager 
  876.           and  switch OFF the facilities of .QWK file  processing 
  877.           confirmation and 'More? Prompts?'.
  878.           
  879.           These facilities are both in the 'Prompting' section of 
  880.           Configuration Manager.
  881.           
  882.           Then, in your script or .BAT file, call Power-QWK using 
  883.           the command POWERQWK X.
  884.           
  885.           When  called  in this manner, Power-QWK  by-passes  the 
  886.           menu system, processes any existent .QWK files and then 
  887.           exits back to the Operating System.
  888.  
  889. 4.   Acknowledgments
  890.      
  891.      Wildcat! is a registered trade mark of Mustang Software.
  892.      
  893.      Qmail is a registered trade mark of SparkWare.
  894.      
  895.      Tomcat!  is  a registered trade mark of  Technique  Computer 
  896.      Systems, Victoria BC, Canada.
  897.  
  898. 5.   Disclaimer
  899.      
  900.      Every  attempt has been made to ensure that Power-QWK  is  a 
  901.      safe and reliable product to use. None the less, neither the 
  902.      Author nor PowerLine Systems Limited may be held responsible 
  903.      for  any  damage caused by its use,  howsoever  such  damage 
  904.      occurs. If you do not accept this, do not use the software.
  905.  
  906. 6.   Registration and Support
  907.      
  908.      If  you  find  this program useful please  register  it  and 
  909.      support  the Shareware concept. Registered users can  obtain 
  910.      support from the Direct-Line Online System. To register your 
  911.      copy of the program please send a cheque or postal order for 
  912.      £20 to:
  913.  
  914.  
  915.                          Powerline Systems Ltd
  916.                          44 Rydal Way
  917.                          Ruislip
  918.                          Middlesex
  919.                          HA4 0RU
  920.  
  921.      Cheques should be made payable to 'Powerline Systems Ltd'.
  922.      
  923.      Please state your name and address on the back of the cheque 
  924.      or  in  a letter accompanying it. Or  print,  complete,  and 
  925.      post, the file PRINT.ME which is distributed with Power-Qwk.
  926.      
  927.      You will be sent a unique registration number to enter  into 
  928.      Power-Qwk using the install program. Once registered to  you 
  929.      the program MUST NOT be passed on to others; only  Shareware 
  930.      copies may be passed on. 
  931.      
  932.      Registered  versions  do not display  the  Shareware  banner 
  933.      displayed by the non-registered version.
  934.      
  935.      Feedback  on  this program is welcomed via  the  Direct-Line 
  936.      Online System. Direct-Line members can leave messages in the 
  937.      POWERSHARE  message area. Non members should use C from  the 
  938.      Main  menu.  Direct-Line operates on the  following  numbers 
  939.      (set your communications software for 8/N/1):
  940.      
  941.      081-841 1847 Speeds 3/12/1200-75/2400
  942.      081-842 2030 Speeds 3/12/24/9600(v32) + HST 9600 & 14,400
  943.      081-842 4176 Speeds 3/12/24/9600(v32) + HST 9600 & 14,400
  944.      081-845-5811 Speeds 3/12/24/9600(v32) + HST 9600 & 14,400
  945.      
  946.      All lines offer MNP5
  947.      
  948.      Latest  versions  are  ALWAYS available  for  download  from 
  949.      Direct-Line.  They  are also placed in the UKFORUM  area  on 
  950.      Compuserve for worldwide access. We welcome suggestions  for 
  951.      enhancements to the program.
  952.      
  953.      
  954.      Copyright (C) Gale Green & Powerline Systems Ltd. 1991
  955.      
  956.      
  957.